Aviation API icon

Aviation API

4.3.x
(0 reviews)

13 MSL Prognosis Charts

The mean sea level (MSL) prognosis charts are drawn by forecasters twice a day. The prognosis charts are a forecast of 18, 30 or 42 hours.

13.1 Latest Prognosis set for a Location

Request the latest set of prognosis charts for the specified region. At this time the only region accepted is nz-au (New Zealand and Australia area).

13.1.1 API Call:

GET /aviation/chart/msl/prognosis/{region}/latest

13.1.2 Path Parameters:

Path ParameterExampleDescription
Regionnz-auA supported region code.

The region code must be lowercase.

This parameter is Mandatory.

13.1.3 Example:

This example would return the latest set of prognosis charts. One chart for each of 18, 30 and 42 hours.

GET /aviation/chart/msl/prognosis/nz-au/latest

13.1.4 API Response:

{
    "version": "1.0",
    "issue-time": "2026-01-06T23:56:29Z",
    "path": "/aviation/api/aviation/chart/msl/prognosis/nz-au/latest",
    "response": [
        {
            "met:locator": "https://api.metservice.com/aviation/assets/chart/msl/nz-au/prog/2026/01/06/18/202601061800_202601071200_202601062128.gif",
            "met:analysis-time": "2026-01-06T18:00:00Z",
            "met:product-name": "msl",
            "met:domain": "aviation",
            "met:issue-time": "2026-01-06T21:28:00Z",
            "av:chart-type": "msl",
            "met:prognosis-period": "018",
            "av:msl-region": "nz-au",
            "met:valid-at": "2026-01-07T12:00:00Z",
            "av:msl-type": "prognosis",
            "met:validity": "12"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/chart/msl/nz-au/prog/2026/01/06/18/202601061800_202601080000_202601062129.gif",
            "met:analysis-time": "2026-01-06T18:00:00Z",
            "met:product-name": "msl",
            "met:domain": "aviation",
            "met:issue-time": "2026-01-06T21:29:00Z",
            "av:chart-type": "msl",
            "met:prognosis-period": "030",
            "av:msl-region": "nz-au",
            "met:valid-at": "2026-01-08T00:00:00Z",
            "av:msl-type": "prognosis",
            "met:validity": "00"
        },
        {
            "met:locator": "https://api.metservice.com/aviation/assets/chart/msl/nz-au/prog/2026/01/06/18/202601061800_202601081200_202601062130.gif",
            "met:analysis-time": "2026-01-06T18:00:00Z",
            "met:product-name": "msl",
            "met:domain": "aviation",
            "met:issue-time": "2026-01-06T21:30:00Z",
            "av:chart-type": "msl",
            "met:prognosis-period": "042",
            "av:msl-region": "nz-au",
            "met:valid-at": "2026-01-08T12:00:00Z",
            "av:msl-type": "prognosis",
            "met:validity": "12"
        }
    ]
}

13.2 Prognosis set for a Location for the next n hours

Request the prognosis charts for the specified region that have a valid at time which is within the next n hours specified At this time the only region accepted is nz-au (New Zealand and Australia area).

13.2.1 API Call:

GET /aviation/chart/msl/prognosis/{region}/next/{n}/hours

13.2.2 Path Parameters:

Path ParameterExampleDescription
regionnz-auA supported region code.

The region code must be lowercase.

This parameter is Mandatory.
n48The number of hours of charts to be returned.

This can be up to 48 hours.

This parameter is Mandatory.

13.2.3 Example:

This example would return the prognosis charts that have a valid at time which is within [request time] -3 hours and [request time] + 48 hours.

GET /aviation/chart/msl/prognosis/nz-au/next/48/hours

13.2.4 API Response:

{
    "version":"1.0",
    "issue-time":"2018-10-15T04:02:33Z",
    "path":"/chart/msl/prognosis/nz-au/next/48/hours",
    "response":[
        {
            "met:locator":"https://api.metservice.com/assets/aviation/anal_prog/mslchart_201810150000_201810140929_nzau_prog_h18.gif",
            "met:analysis-time":"2018-10-14T06:00:00Z",
            "met:product-name":"msl",
            "met:domain":"aviation",
            "met:issue-time":"2018-10-14T09:29:00Z",
            "met:prognosis-period":"18",
            "av:msl-region":"nz-au",
            "met:valid-at":"2018-10-15T00:00:00Z",
            "av:msl-type":"prognosis",
            "met:validity":"00"
        },
        {
            "met:locator":"https://api.metservice.com/assets/aviation/anal_prog/mslchart_201810151200_201810142130_nzau_prog_h18.gif",
            "met:analysis-time":"2018-10-14T18:00:00Z",
            "met:product-name":"msl",
            "met:domain":"aviation",
            "met:issue-time":"2018-10-14T21:30:00Z",
            "met:prognosis-period":"18",
            "av:msl-region":"nz-au",
            "met:valid-at":"2018-10-15T12:00:00Z",
            "av:msl-type":"prognosis",
            "met:validity":"12"
        },
        {
            "met:locator":"https://api.metservice.com/assets/aviation/anal_prog/mslchart_201810160000_201810142130_nzau_prog_h30.gif",
            "met:analysis-time":"2018-10-14T18:00:00Z",
            "met:product-name":"msl",
            "met:domain":"aviation",
            "met:issue-time":"2018-10-14T21:30:00Z",
            "met:prognosis-period":"30",
            "av:msl-region":"nz-au",
            "met:valid-at":"2018-10-16T00:00:00Z",
            "av:msl-type":"prognosis",
            "met:validity":"00"
        },
        {
            "met:locator":"https://api.metservice.com/assets/aviation/anal_prog/mslchart_201810161200_201810142132_nzau_prog_h42.gif",
            "met:analysis-time":"2018-10-14T18:00:00Z",
            "met:product-name":"msl",
            "met:domain":"aviation",
            "met:issue-time":"2018-10-14T21:32:00Z",
            "met:prognosis-period":"42",
            "av:msl-region":"nz-au",
            "met:valid-at":"2018-10-16T12:00:00Z",
            "av:msl-type":"prognosis",
            "met:validity":"12"
        }
    ]
}

Reviews